home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / renegade / b2d101.zip / BBS2DIR.DOC < prev    next >
Text File  |  1994-08-02  |  7KB  |  175 lines
  1. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2. BBS2Dir version 1.01
  3.   for Renegade BBS System version 5-31+
  4.  
  5. FILES.BBS -> *.DIR importer
  6.   for the importation of files using FILES.BBS-type description files
  7.  
  8. Released 08-01-94
  9.  
  10. Programmed by Jason Almeida and Corbett Klempay
  11.               JC Computer Consulting
  12. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  13.  
  14.  
  15. 1  DISCLAIMER
  16.  
  17.     BBS2Dir and its configuration program (B2DCFG hereafter) are distributed
  18. as is, with no warranty of any kind.  In no event shall the authors, Jason
  19. Almeida and Corbett Klempay, be liable to you or anyone else for any damages
  20. or costs incurred through the use of BBS2Dir.
  21.  
  22.     No part of BBS2Dir may be modified, altered, reverse-engineered, or in any
  23. way changed.  BBS2Dir may not be sold or distributed for profit without written
  24. permission from the authors.
  25.  
  26.     The distribution of unmodified copies of BBS2Dir is highly encouraged.  JC
  27. Computer Consulting is always happy to allow shareware CD-ROM distributors to
  28. put our programs on their CD-ROMs.
  29.  
  30.     BBS2Dir is a trademark of Jason Almeida and Corbett Klempay.  Renegade
  31. BBS System is a trademark of Cott Lang.  LZEXE is a trademark of Fabrice
  32. Bellard.  ARJ is a trademark of Robert Jung.  PKZip is a trademark of Phil
  33. Katz.  LHA is a trademark of Haruyasu Yoshizaki.
  34.  
  35.  
  36.  
  37. 2 REGISTRATION INFORMATION
  38.  
  39.  
  40.     BBS2Dir is shareware.  The unregistered version differs from the
  41. registered in a couple ways :  After every 5th directory is processed, there
  42. will be a short beep.  Upon completion, BBS2Dir will beep 4 times.
  43.  
  44.     If you like BBS2Dir, or just wish to set your conscience at ease, you
  45. can send any donation ($5 and up, please) to the authors for all the hard
  46. work that went into the making of this quality program.  Upon receipt of a
  47. donation, we will either send you netmail via FidoNet or ITCNet containing
  48. your registration number, or we will send you a letter with your
  49. registration number.  When registering, fill out the complete registration
  50. form (REGFORM.JC)  Upon receiving your registration number, go into
  51. B2DCFG.EXE and select the registration selection.  Enter the information
  52. sent to you into the configuration program EXACTLY as you see it.
  53.  
  54.     * NOTE : For more information about registering your copy of BBS2Dir,
  55. consult REGFORM.JC.
  56.  
  57.  
  58.  
  59.  
  60. 3  INSTALLATION
  61.  
  62.  
  63.     Installation of BBS2Dir is quite easy.  All you have to do is unARJ the
  64. B2D100.ARJ archive into your Renegade main directory (i.e. C:\BBS\).  After
  65. that is done, run B2DCFG.EXE to configure BBS2Dir to your specifications.
  66. Make sure you have B2DCFG search your hard drive for ARJ.EXE, PKUNZIP.EXE,
  67. and LZH.EXE if you wish to have BBS2Dir search for FILE_ID.DIZ's.  After
  68. completing configuration, you can execute BBS2DIR.EXE.  The preferred way
  69. to run BBS2Dir is in a echomail event (if you are using BBS2Dir for file
  70. echoes).  If you are using BBS2Dir to import a CD-ROM, you must first define
  71. the new file bases in Renegade.  Be sure to flag the bases as CD-ROM if
  72. necessary.  Otherwise, BBS2Dir will detect an error when running.  BBS2Dir
  73. will read the FILES.BBS in each directory and import all files there if
  74. the directories are setup correctly.  BBS2Dir can take two optional
  75. parameters.  The first is the user number corresponding to the user who
  76. should receive credit for uploading the files.  In most cases, this should
  77. be user #1 (you).  For this reason, user #1 is the default user to be credited
  78. with uploads.  The other parameter is an optional alternate name for FILES.BBS
  79. (some CD-ROMs have filenames ending with .DIR).  Note that this list does not
  80. support wild cards.
  81.  
  82. Example command line:  BBS2DIR 2 OS2.DIR
  83.  
  84.     This command line would process the files described in OS2.DIR.  User
  85. #2 would be credited with the uploads.
  86.  
  87.     * NOTE : The executables have been LZEXE'ed to save space on the user's
  88. hard drive and to prevent corruption.  LZEXE'ed files perform a simple CRC
  89. self-check each time they are run, so do not attempt to hexedit either of
  90. the files; they will not run afterwards.
  91.  
  92.  
  93.  
  94.  
  95.  
  96. 4  TROUBLESHOOTING
  97.  
  98.  
  99. Q:  I don't have B2DCFG.EXE, and BBS2Dir won't run without it.  What should
  100.     I do?
  101. A:  You have not gotten a complete copy of BBS2Dir.  To get a complete copy,
  102.     call the BBS at the end of this documentation.
  103.  
  104. Q:  Which versions of Renegade will this work for?
  105. A:  We have only tested it on 5-31.  However, we are going to try it on
  106.     different versions and report the results on the ITCNet Renegade echo,
  107.     and there will also be a file available on The Garden.
  108.  
  109. Q:  In BBS2DIR.LOG, non-existent files show up.  The filenames begin with a
  110.     character such as "|", "+", etc. and are followed by lowercase letters.
  111.     Ex: "+ for file ech"
  112. A:  In B2DCFG there is an option for the extended description character.
  113.     Assign this to be the first character in the "filename".  Unless you
  114.     have a back-up of the FILES.BBS used to import the file, you will be
  115.     unable to import the extended description with the file.  The
  116.     description for the file will only have the first line, but will be
  117.     otherwise intact.
  118.  
  119. Q:  Something happened to BBS2Dir that wasn't covered in this Troubleshooting
  120.     section.
  121. A:  Netmail us via FidoNet or ITCNet, send us a letter, or fax us about the
  122.     problem, and we will try to resolve it.
  123.  
  124.  
  125.  
  126.  
  127. 5  THE FUTURE OF BBS2Dir
  128.  
  129.     The future of BBS2Dir depends heavily on the response we receive from
  130. you, the user.  If we find people are interested in BBS2Dir, then we will
  131. probably continue to improve it.
  132.  
  133. Possible options for the future :
  134.  
  135. 1.  Sets of files for CD-ROMs such as Monster Media, so the sysop doesn't
  136.     have to go through the tedious procedure of creating all the
  137.     directories.
  138.  
  139. 2.  The ability to choose which directories should be processed.
  140.  
  141. 3.  Create FILES.BBS from existing file records in Renegade.
  142.  
  143.    As you can see by our rather short list, we are unsure of what the next
  144. step for BBS2Dir should be.  We would appreciate any feedback which could
  145. aid us in planning the future of BBS2Dir.
  146.  
  147.  
  148.  
  149.  
  150. 6  WHERE TO CONTACT THE AUTHORS
  151.  
  152.     To get the latest copy of BBS2Dir, you can FREQ it from the BBS below
  153. using the magic filename "BBS2DIR" (without quotes).  We would appreciate
  154. any feedback you may have regarding BBS2Dir, compliment or criticism.  We
  155. rely on the comments and constructive criticism provided by users in order
  156. to enhance and correct our programs.  Even if you have no problems or
  157. suggestions to voice, feel free to let us know what you think of BBS2Dir.
  158. comments and suggestions can be directed to us at The Garden or our mailing
  159. address below.  The Garden is a free access BBS that is open to all who
  160. apply.
  161.  
  162.                         The Garden
  163.                    FidoNet (1:2240/200)
  164.                     ITCNet (85:871/617)
  165.                    ZyXELNet (18:1070/0)
  166.                      DogNet (34:100/100)
  167.                    (810)695-6222 BBS/Fax
  168.              Supports v.32bis, ZyXEL 16800/19200
  169.  
  170. Mailing address :
  171.  
  172.                     JC Computer Consulting
  173.                     9774 Burning Tree Dr.
  174.                     Grand Blanc, MI 48439
  175.